home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Grab Bag
/
Shareware Grab Bag.iso
/
004
/
handicap.arc
/
HANDICAP.DOC
< prev
next >
Wrap
Text File
|
1985-08-04
|
38KB
|
887 lines
H A N D I C A P
Version 1.3
A Program to Keep Track of Your Golf Scores
and Your Golf Handicap
Copyright 1985 Richard T. Wright
All rights reserved
You are encouraged to copy this program and its documentation and
to share them with others on the following conditions:
1. No changes or alterations may be made to the program
or its accompanying files (including this documentation).
2. No fee or other consideration may be charged for any
copy.
3. Neither this notice nor those on the opening and second
screens of the program may be changed or bypassed.
Any comments, suggestions for improvements, or invitations to play
golf will be appreciated and should be sent to:
WRIGHT SOFTWARE ENTERPRISES
P. O. Box 6488
Annapolis, Maryland 21401
IF YOU USE AND ENJOY THIS PROGRAM, RECEIPT OF YOUR $20.00
REGISTRATION CONTRIBUTION WILL BE VERY MUCH APPRECIATED. PLEASE
MAKE THIS CONTRIBUTION AND DO YOUR PART TO ENCOURAGE
USER-SUPPORTED SOFTWARE.
TABLE OF CONTENTS
BASIC PURPOSE . . . . . . . . . . . . . . . . . . . . . . . . 1
A FEW WORDS ABOUT TERMINOLOGY AND SPECIAL KEYS . . . . . . . . 1
DATA ENTRY INFORMATION . . . . . . . . . . . . . . . . . 1
"Enter" or "carriage return" . . . . . . . . . . . . 1
Letter key shown in parentheses . . . . . . . . . . 2
Backspace . . . . . . . . . . . . . . . . . . . . . 2
Escape . . . . . . . . . . . . . . . . . . . . . . . 2
Data entry fields . . . . . . . . . . . . . . . . . 2
GOLF HANDICAP TERMINOLOGY . . . . . . . . . . . . . . . . 2
Gross Score . . . . . . . . . . . . . . . . . . . . 2
Adjusted Score . . . . . . . . . . . . . . . . . . . 2
Differential . . . . . . . . . . . . . . . . . . . . 3
ABOUT THE HANDICAP PROGRAM . . . . . . . . . . . . . . . . . . 4
INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . 4
USING THE HANDICAP PROGRAM . . . . . . . . . . . . . . . . . . 6
Main Menu choice 1 . . . . . . . . . . . . . . . . . . . 6
Main Menu choice 2 . . . . . . . . . . . . . . . . . . . 6
Main Menu choice 3 . . . . . . . . . . . . . . . . . . . 6
Main Menu choice 4 . . . . . . . . . . . . . . . . . . . 6
Main Menu choice 5 . . . . . . . . . . . . . . . . . . . 6
Main Menu choice 6 . . . . . . . . . . . . . . . . . . . 7
Main Menu choice 7 . . . . . . . . . . . . . . . . . . . 7
ENTERING SYSTEM CUSTOMIZING INFORMATION . . . . . . . . . . . 7
ENTERING ROUND INFORMATION (MAIN MENU CHOICES 1 AND 2) . . . . 8
EDITING ROUND INFORMATION (MAIN MENU CHOICE 4) . . . . . . . . 9
LEARNING THE PROGRAM . . . . . . . . . . . . . . . . . . . . . 11
USER-SUPPORTED SOFTWARE . . . . . . . . . . . . . . . . . . . 11
REGISTRATION/ORDER FORM . . . . . . . . . . . . . . . . . . . 13
i
BASIC PURPOSE:
The basic purpose of HANDICAP is to make you a better golfer
and to have more fun playing golf. The program keeps track
of your golf scores and other information about the rounds of golf
you play and calculates your handicap in accordance with United
States Golf Association prescribed methods. (No sponsorship by
the U.S.G.A is claimed by the author.) Hopefully, by observing
scoring and play tendencies, you can figure out how to play
better. At the very least, HANDICAP will give you a good argument
for the appropriate number of strokes when comparing and adjusting
your scores to those of your playing partners.
HANDICAP allows you to prepare two reports to either your
screen or printer:
First, you can print out your current handicap and a
list of all the rounds used in the calculation of that handicap.
Rounds which comprise that actual basis of your handicap are
specially designated.
Second, the program will allow you to print selected
rounds from those you have stored. You can select all your
rounds, rounds for a certain course, rounds for any period, or
rounds for a certain course during a certain period. After
displaying the information you desire for this second type of
report, the program calculates and displays the average gross
score, adjusted score and differential for the rounds selected.
If you have the Multi-Golfer Version of HANDICAP, the program
allows you to print or display the above two reports for each
golfer stored in the system and a third report which is a list of
all golfers in the system and their respective handicaps.
A FEW WORDS ABOUT TERMINOLOGY AND SPECIAL KEYS . . .
Throughout the program and this documentation, certain
keyboard keys and terms are repeatedly used which have special
meanings:
DATA ENTRY INFORMATION:
You will often be asked to "ENTER" certain information. This
means you should type in the information and press the "enter" or
"carriage return" key when you are done. Pressing the carriage
return key is necessary to complete the entry of any field (other
than a date information field) which is longer than one character
because the program has no other way of knowing when you are done
entering information in that field.
1
Occasionally, the program may ask you to press the "C/R" key
if you want to do something. "C/R" stands for carriage return or
the "enter" key. All you have to do is press this key once to
perform the indicated operation.
Some portions of the program ask you to make a choice among
several alternatives, such as "(Y)es or (N)o" and "(C)hange or
(D)elete". To indicate your choice, you merely need to press the
letter key shown in parentheses for the appropriate word. (For
example, the "Y" key for "Yes", the "N" key for "No", the "C" key
for "Change" and the "D" key for "Delete".) It doesn't matter
whether or not you capitalize the key selected by pressing the
shift key at the same time. HANDICAP will automatically convert
all of such entries to upper case.
Throughout the program, the backspace key and the escape key
on your keyboard have special significance for correcting
mistakes. The backspace key is "destructive". With the exception
of date entry, if you mistype information or otherwise want to
change your entry before you have pressed the carriage return key
to indicate finality, you can backspace to the characters to be
changed and then retype the information as you want it to be.
Backspacing eliminates the characters which are erased on your
screen. Alternatively, to erase everything entered on the line
and start over, you merely need to press the escape key. If you
are at the beginning of a line of information input and you press
the escape key, the program will erase your prior entries on the
screen and restart your input for the entire screen. Thus, if you
are inputing information to the screen and you discover a mistake
in a prior line which has already been "entered", you can restart
information entry on the screen by pressing the escape key at the
beginning of any information field.
All data entry fields shown on the screen are marked by lines
of periods, such as:
Course: ..................................
The periods indicate the permissible maximum length of the
information to be put into the system. (Each period represents a
permissible character input area.) If you exceed the length
of the line of periods, the program will reject your entry, blank
out the line, and ask you to restart.
GOLF HANDICAP TERMINOLOGY:
Your "Gross Score" for any round of golf is the actual round
score as shown on your scorecard. Every stroke counts if it would
count under the rules of the game.
Your "Adjusted Score" is your gross score for the round
adjusted by what the U.S.G.A. calls "Equitable Stroke Control".
2
Basically, "Equitable Stroke Control" is your protection against
"sandbaggers". It works as follows:
If you are a scratch (0 handicap) or plus (i.e. minus)
handicap golfer, you are not allowed to count any stroke which is
more than one over par for any given hole. If you are in this
category, to calculate your adjusted score you would subtract one
stroke from your gross score for each double bogey you scored, two
strokes for each triple bogey, three strokes for each quadruple
bogey, etc.
If your handicap is between 1 and 18, you are allowed to
count only as many double bogeys as equals your handicap. You are
not allowed to count any stroke which is more than two over par
for any given hole. Thus, if you were to have a handicap of 3 and
you had a gross score for a round which included five double
bogeys and a triple bogey (a thoroughly rotten day!), you would
calculate your adjusted score for the round by subtracting one
stroke each for the fourth and fifth double bogeys and two strokes
for the triple. (Subtracting only one stroke for the triple would
give you a fourth double bogey.) Your adjusted score would
therefore be 4 less than your gross score.
If your handicap is between 19 and 36, you are allowed
to count all of your double bogeys but only as many triple bogeys
as equals your handicap minus 18. You are not allowed to count
any stroke which is more than three over par for any given hole.
Thus, if you were to have a handicap of 21 and you had a gross
score for a round which included five triple bogeys and a
quadruple bogey, you would calculate your adjusted score for the
round by subtracting one stroke each for the fourth and fifth
triple bogeys and two strokes for the quadruple. (Again,
subtracting only one stroke for the quadruple would give you a
fourth triple bogey.) Your adjusted score would therefore be 4
less than your gross score.
If your handicap is between 37 and 40, besides needing a
lot of help beyond the scope of this program, you are allowed to
count all of your double and triple bogeys but only as many
quadruple bogeys as equals your handicap minus 36. You are not
allowed to count any stroke which is more than four over par for
any given hole.
For obvious reasons, HANDICAP does not calculate your
adjusted score automatically. You have to do it on your own. I
find the best way to perform "Equitable Stroke Control" is to
adjust my gross score on my scorecard right after counting up my
gross score.
The "Differential" for any round of golf is the difference
between your "adjusted score" and the course rating for the course
you played. U.S.G.A. handicaps are based on combined
3
differentials so golfers playing different courses can compare
their games on a common basis. HANDICAP requires you to enter for
each round the course rating for the course you played (the
program will do this automatically if the course is the usual one
you regularly play) and your adjusted score for the round. The
program then automatically calculates and stores the differential
for the round. Displaying or printing your rounds (i.e., all of
them, those for a given period, those for a certain course, or
those for a given course during a certain period) will also cause
to be displayed or printed the average differential for the
rounds selected.
ABOUT THE HANDICAP PROGRAM
Your distribution copy of HANDICAP should have the following
files:
HANDICAP.COM the basic HANDICAP program
HANDICAP.DOC this documentation
HCPINST.COM a screen installation program
HCPINST.MSG which allows you to customize
HCPINST.DTA HANDICAP to your particular
screen
Once you have run HANDICAP, additional files having the
extension ".DTA" will be created. These files include
HDEFAULT.DTA a data file which includes the
customizing default information
you enter for your program
HANDICAP.DTA a data file which includes the
names and handicaps of all
golfers stored in the system
plus various files named
********.DTA data files for each golfer stored
in the system
(the asterisks used above will be replaced by letter characters in
your data files).
INSTALLATION
To install HANDICAP, you merely need to copy the files
included with your distribution copy onto a disk (floppy or hard)
formatted with your operating system.
If you have an IBM PC or close compatible, you probably need
to do nothing further to run the program other than to enter the
4
word "HANDICAP" after you boot up and see your DOS prompt (e.g.,
"A>" or "C>") displayed.
If you don't have a close IBM PC compatible, before you use
HANDICAP, it must be installed to your particular terminal, i.e.
provided with information regarding control characters required
for certain functions. This installation is easily performed
using the program HCPINSTALL which is described in the following:
After having made a work-copy, store your distribution
diskette safely away and work only on the copy. Start the
installation by typing "HCPINSTALL" at your terminal. Next,
select Screen installation from the main menu. If you use
HANDICAP without installation, the default screen set-up will
be used. You may override this default by selecting another
screen mode from this menu:
-----------------------------------------------------------------
Choose one of the following displays:
0) Default display mode
1) Monochrome display
2) Color display 80x25
3) Color display 40x25
4) b/w display 80x25
5) b/w display 40x25
Which display (enter no. or ^X to exit)
-----------------------------------------------------------------
Each time HANDICAP runs, the selected mode will be used, and you
will return to the default mode on exit.
5
USING THE HANDICAP PROGRAM
HANDICAP is completely menu driven. When you run HANDICAP,
after proceeding through the opening screen(s), you are presented
with the following Main Menu screen:
--------------------------------------------------------------
PROGRAM ACTIVITIES:
1 - ADD NEW ROUND INFORMATION AND CALCULATE NEW HANDICAP
2 - ADD NEW ROUND INFORMATION (NO NEW HANDICAP CALCULATION)
3 - RECALCULATE HANDICAP USING ROUNDS ALREADY IN SYSTEM
4 - SEE, CHANGE, OR DELETE ROUND INFORMATION
5 - PREPARE REPORTS
6 - SYSTEM CHANGES
7 - EXIT FROM PROGRAM TO DOS
WHAT IS YOUR CHOICE? (1, 2, 3, 4, 5, 6, or 7) .
--------------------------------------------------------------
The Main Menu lists all of the activities carried on by the
program. The user merely selects the number appropriate to the
task he or she wants performed.
(If the user is using the Multi-Golfer Version of HANDICAP,
he will next be prompted to indicate the first and last names of
the particular golfer for which he wants the menu task performed.)
Normally, the user will want to input one or more rounds into
the system and to have his updated handicap displayed after doing
so. Menu choice 1 accomplishes this task. Alternatively, the
user can use menu choice 2 to input one or more rounds into the
system without a new handicap calculation. Menu choice 3 can be
used to display a handicap based on existing rounds stored in the
system at any time (such as after rounds are input without new
handicap display or after rounds put in out of order are resorted
as discussed below).
If you ever want to see what information you've entered for a
given round, change that information, or delete the information,
choose menu option 4.
Menu option 5 allows you to print to the screen or your
printer the reports generated by the program.
6
Menu choice 6 allows you to do one of two things: First, you
can enter or change default information which customizes your
HANDICAP copy to you. HANDICAP invokes this choice automatically
the first time you attempt to enter a round into the system.
Thereafter, this customizing information can be changed by first
electing Main Menu choice 6 and then selecting choice A on the
System Changes Menu. Alternatively, should you enter rounds out
of order, choice B on the System Changes menu will resort the
rounds in your system by date. (If two rounds have the same date,
the first round entered will be considered as having been played
first.)
(The Multi-Golfer Version of HANDICAP also includes a C
option on the System Changes menu which allows you to delete a
golfer from your system.)
Menu choice 7 obviously ends the program and returns you to
your operating system prompt.
ENTERING SYSTEM CUSTOMIZING INFORMATION
When you first use HANDICAP or when you select Main Menu
choice 6 and then the A choice on the System Changes Menu, the
program takes you through a series of questions designed to obtain
information to customize HANDICAP to your particular needs:
First, you are asked to enter the default golfer's first
name. The default golfer is the user in the distribution version
of HANDICAP and the golfer who most often uses the system in the
Multi-Golfer Version. After entering the default golfer's first
name, you are next prompted to enter that golfer's last name.
Each of these entries may be up to 15 characters long.
You are next prompted to enter the name of the "default golf
course". This entry is the golf course for which rounds are most
likely to be entered and can be up to 35 characters long. After
this, HANDICAP prompts you to enter a four digit (including
the decimal point) entry to indicate the most commonly used course
rating for the default golf course. Storing this information
allows the input of these items when entering round information
with a single keystroke.
(After entering the default golf course rating, the
Multi-Golfer Version of HANDICAP asks you if you want to operate
in a single golfer or a multi-golfer mode. Choice of the single
golfer mode simplifies usage when only one golfer is using the
system until the choice is changed by a subsequent reinput of the
customizing data input. If you choose to operate in the
Multi-Golfer mode, the Multi-Golfer Version then asks you to
indicate on which drive (A, B, or C) your data (".DTA") files will
be kept. Multi-Golfer Version data file storage is limited only
7
by the storage limits of the storage medium chosen. Numerous
golfers can be accommodated on several floppy disks if necessary.)
After responding to all of the customizing information
inquiries, the program prompts you to look over what you have
entered and to make sure that the information typed in is
appropriate. At this point, press the "Y" key if everything looks
satisfactory and the "N" key if you find a mistake and want to
restart from the beginning.
ENTERING ROUND INFORMATION (MAIN MENU CHOICES 1 AND 2)
When you select Main Menu choices 1 or 2, HANDICAP displays
the following screen:
-----------------------------------------------------------------
GOLFER: **********************
CURRENT HANDICAP: **
Round Number: .
Date (MM/DD/YY): ........
Course ...................................
Course Rating: ....
Gross Score: ...
Adjusted Score: ...
Comments: ...................................
-----------------------------------------------------------------
The current golfer's name is displayed so you can make sure
that your information will be stored for the appropriate golfer.
The handicap for that golfer is displayed as an aid in calculating
any adjustments to the Gross Score (according to
U.S.G.A. Equitable Stroke Control requirements) to establish the
golfer's Adjusted Score.
Once the input screen has been displayed, HANDICAP
automatically supplies the Round Number for you and displays this
number in the appropriate blank.
The first blank you are prompted to complete is that for the
date of the round you wish to enter. Because the date field
information is used to sort rounds into proper order, date entry
in HANDICAP is somewhat structured. You must enter date
information in the indicated month/date/year format. Single digit
entries must be preceded by a zero. Slashes are supplied
automatically for you. To save keystrokes, the first digit of the
8
year ("8") is also always supplied for you. You only need to
press the appropriate keys for the month number, date number and
final digit of the appropriate year. You do not have to press the
carriage return key when you are done entering the date. HANDICAP
knows when you are done by the number of keystrokes pressed.
After pressing the appropriate keys for the date, you are
next prompted to enter the name of the course played during the
round. If the course is the default golf course entered for the
system, you merely need to respond to this prompt by pressing the
carriage return key and the course name and rating are
automatically supplied. If a course other than the default golf
course was played, enter the name of the course (up to 35
characters) and then the course rating (up to 4 characters
including the decimal indicator).
You are next prompted to enter the Gross Score and the
Adjusted Score for the round. Calculate the golfer's adjusted
score as discussed above using Equitable Stroke Control. If the
Adjusted Score is the same as the Gross Score, you need merely
press the carriage return key at the appropriate line and the
adjusted score will be automatically displayed.
Finally, you are prompted to input any comments you may care
to save to better remember the round or other information about
it. You are not required to enter any comments and may merely
press the carriage return key to bypass this field.
After proceeding through all of these input prompts, HANDICAP
asks you to make sure that the information you have typed is
correct. Read over your entries to make sure that they say want
you want. Press the "Y" key if you are satisfied or the "N" if
you want to start over to correct an error. (If you see a
mistake, you can still press the "Y" key to record the round and
then edit it using Main Menu choice 4.)
Once you have responded that you are satisfied with the
information entered, HANDICAP stores the round information to a
disk file and asks you if you want to input another round. If so,
the program restarts the round information input screen process.
If not, HANDICAP either recalculates and displays the golfer's
handicap (Main Menu choice 1) or returns you to the Main Menu
(Main Menu choice 2).
EDITING ROUND INFORMATION (MAIN MENU CHOICE 4)
If you have entered round information and subsequently want
to see it, change it, or delete the round altogether, select Main
Menu choice 4.
9
When this procedure is selected, a round input screen
comparable to that shown above is displayed and you are prompted
to select a round either by Round Number or by Date. HANDICAP
then searches for the round meeting the indicated criteria and
either displays this round to the screen or indicates that such a
round can't be found. If the round displayed is not that which
you wanted, respond the to question "IS THIS THE ROUND YOU WISHED
TO CHOOSE?" with an "N" and you will restart the round selection
process.
Once the round you wished to see, change or delete is
displayed and you have confirmed your selection, HANDICAP asks you
if you want to "(C)hange" or "(D)elete" the information displayed.
If you want to delete the displayed round, answer the change
or delete inquiry with a "Y" and then press the "D" key to confirm
the deletion. The round information will then be irrevocably
erased from the system.
If you want to change any of the round information displayed,
answer the change or delete inquiry with a "Y" and then press the
"C" key. Each of the changeable fields will then be shown with a
capital letter (A through F). To change information in a field,
press the key for the letter associated with that field and then
merely reenter the information on the indicated line as you want
it to be stored. After completing the data reentry, respond to
the "ARE YOU SURE . . ." inquiry with a "Y".
After you've changed the information for one field in a
round, HANDICAP asks you if you want to change the information in
any other field. If you answer with a "Y", repeat the process
described above for the chosen field. Once you enter a "N" here,
the edited information is stored to disk in place of the old round
information, and the program will ask you if you want to see,
change or delete any other rounds. Once you respond to this
inquiry with a "N", you are returned to the Main Menu.
PLEASE NOTE THE FOLLOWING ABOUT EDITED ROUNDS:
If you change the Date for a stored round, you will have
to resort your rounds using Main Menu choice 6 and System Changes
Menu choice B to put your rounds in proper order for handicap
calculation.
If you delete a round, you do not have to resort your
rounds. The deleted round is erase from the system and all
remaining rounds in the system are automatically renumbered.
If you start to change the information in any round
field and then change your mind (or if you press the wrong field
designation letter key), you can "escape" the change at any time
10
before pressing the carriage return key ending the edit of the
field in question. Pressing the escape key after entering one or
more characters will restart data entry in the designated field
and place the cursor under the first character. Pressing the
escape key again will stop the edit for that field and redisplay
the information previously entered.
LEARNING THE PROGRAM . . .
Use of HANDICAP doesn't really need much more description.
(It probably doesn't need as much as is included above.)
Throughout the program you are almost always prompted with
the range of permissible responses, and, if you make a mistake,
HANDICAP will let you know and then restart you at the point where
the mistake was made.
If you want to try to learn the program on a trial basis
before entering true-to-life information, make up a fictitious
golfer name, etc. (e.g., George Sample), enter information for him
when you customize the system information, and then enter some
fictitious rounds. (I would enter at least five rounds so you can
obtain a handicap calculation.) Print or display both the A and B
reports for your fictitious rounds until you become comfortable
with the system. When you're comfortable, reenter the System
Changes Menu from the Main Menu (choice 6) and then recustomize
your system to yourself.
USER-SUPPORTED SOFTWARE (A COMMERCIAL FOR MYSELF)
If you've obtained a copy of HANDICAP, you are probably
familiar with the concept of user-supported software.
Free distribution of software and voluntary payment for its
use eliminates the need for bothersome copy protection schemes and
reduces the price of software by eliminating advertising and
marketing costs. Users get to try out software at a relaxed pace
and setting. Good programs are rewarded based solely on their
quality and utility.
I've tried to make HANDICAP as "commercial" in appearance
and as easy to use as possible. After all, we'd all rather be
playing golf than learning new software. (If you have any
suggestions for improvements, I'd appreciate hearing them.) As my
wife can attest, development of this program took an awful lot of
time and effort. Like anyone else, I'd like to be compensated for
that time and effort.
If you like my program and find it to be of use, I'd
appreciate receiving a registration contribution of $20.00. If
you like the program, I think the price is a fair one.
11
As I've indicated above, a Multi-Golfer Version of HANDICAP
is available for purchase. To obtain the Multi-Golfer Version,
you must be a registered owner of the distribution (single user)
version. The Multi-Golfer Version is available for $35.00 (over
and above the $20.00 initial registration contribution). To order
the Multi-Golfer Version, complete the following order form and
send me a MS-DOS or PC-DOS formatted five and a quarter inch
floppy diskette and your check in the appropriate amount.
Thanks for using and supporting HANDICAP.
Richard T. Wright
Wright Software Enterprises
P. O. Box 6488
Annapolis, Maryland 21401
12
********************* REGISTRATION/ORDER FORM ********************
(Please print or type)
TO: WRIGHT SOFTWARE ENTERPRISES
P. O. BOX 6488
ANNAPOLIS, MARYLAND 21401
FROM: ____________________________________________
____________________________________________
____________________________________________
____________________________________________
Telephone: (_____) _________________________
Check the appropriate blank:
( ) Please register me as a user of HANDICAP. My $20.00
registration contribution is enclosed.
( ) Please send me a copy of the Multi-Golfer Version of
HANDICAP. I have enclosed a MS-DOS or PC-DOS formatted
five and a quarter inch disk and $35.00 (over and above
the registration contribution) for the price of this
version of the program.
Total amount enclosed: $ _______________
Comments about HANDICAP and/or suggestions for improvement:
*****************************************************************
13
